软件功能的开发与修改

很多人第一次想让 AI 给自己做一个功能时，第一反应都是：去任务管理里新建一个任务，任务名写「开发一个登录功能」，描述写「做一个用户能注册登录的页面」，然后点保存，等 AI 干活。

这是个很自然的想法，但它是最容易失败的做法。原因不复杂：AI 拿到这句话，会自己"猜"你要什么——猜注册要几个字段、猜密码要不要加密、猜登录后跳到哪个页面、猜要不要找回密码。它猜出来的东西，八成跟你脑子里想的不一样。等你看到结果再一句句纠正，来回折腾的时间和钱，比一开始老老实实花二十分钟把需求说清楚要多得多。

这一章要做的，就是把这件"直觉上会做错"的事纠正过来，给你两条正道：

• 分清「新建软件工程」「软件修改」「通用任务」三种任务类型，知道各自适合什么场景
• 会用软件工程向导（新建）七步走完一个功能从想法到任务的完整流程
• 会用软件修改弹窗，把"改一个已有功能"讲清楚再创建任务
• 知道什么时候才该用普通的「新建任务」，以及引擎（循环执行 / Agent 智能体）怎么选
• 掌握一套非技术背景也能用的"需求表达法"，把模糊想法写成 AI 能执行的需求

零、先分清三件事：你到底想做哪一种？

在打开任何页面之前，先在心里定位你的目标。三类目标，对应三条完全不同的路，走错了就要返工。

下面我们就按这三条路，一条一条讲清楚。

一、先搞懂三种任务类型

所有软件相关的活儿，最终都会变成任务（task）进入自动运营的排班。但在任务管理页新建任务时，"任务类型"这一个选项，决定了这个任务走什么链路、要不要先做设计。

进入「任务管理」页，右上角是 新建任务 按钮。点开后会看到一个「新建任务」弹窗，里面有这些字段：

通用任务（general）——最简单的一类

选「通用任务」，点保存，任务就直接创建好了，状态是待执行（pending），等着自动运营调度它。它没有设计阶段，你描述什么，AI 就尽力做什么。

适合：调研、分析、写文案、整理资料、生成素材、跑一次性脚本这类非软件交付物的工作。

新建软件工程（eng）——做新功能的正道

选「新建软件工程」，点保存后不会直接创建任务，而是会发生两件事：

1. 系统先建一个"规划中"的任务

   任务会被创建出来，但状态是规划中（planning）。这个状态很关键：规划中的任务不会被执行，调度器会跳过它。所以它不会在你还没设计好的时候就自己跑去写代码。

2. 自动弹出「新建软件工程」向导

   一个七步的向导对话框打开了，标题是「新建软件工程」。你在这里完成需求对齐、设计确认、模块拆分，最后点「创建任务」，任务才会从"规划中"变成"待执行"。

软件修改（mod）——改已有功能的正道

选「软件修改」，你会先看到一个必填的下拉框「关联软件工程」——它列出的是本项目里已有的软件工程任务。你必须先选中要改的那个工程，否则点保存时系统会提示「请选择要修改的软件工程」。

保存之后，同样先建一个"规划中"的任务，然后自动弹出「软件修改」对话框。你在对话框里跟 AI 聊清楚改法，确认后任务才转成"待执行"。

一张表帮你选对类型

任务状态一览：你在列表里会看到什么

不管选哪种类型，任务最终都会出现在任务列表里，带着一个状态标签。看懂这几个状态，你就知道任务走到哪一步了：

二、正道 A：新建软件工程（软件工程向导）

这是"怎么创建项目中的复杂软件功能"这个问题的官方答案。整个向导一共七步，你不需要懂代码，只需要在每一步做"确认"和"提意见"。

进入方式：任务管理 → 新建任务 → 任务类型选 新建软件工程 → 填好名称和描述 → 点 保存。向导会自动打开。

向导顶部是一条步骤条，七步分别是：

底部按钮会随步骤变化，一共用到这几个：上一步 下一步 保存并下一步 应用评审 创建任务。

第 1 步 · 需求对齐

这一步是一个对话框。下方输入框的占位提示是「描述你的软件工程需求（目标、功能、技术栈等）...」，右边是 发送 按钮。你用大白话把想做的事说给 AI，AI 会反过来问你问题，一来一回把需求聊清楚。

你要说的四件核心信息：

AI 通常会追问什么：目标用户是谁、有没有特殊情况要处理、要做在网页端还是手机端、有没有必须用的技术或不能碰的既有系统、"什么情况算做完"。

怎么算"对齐完成"：有一个简单的判断标准——如果 AI 用一段话复述它理解的需求，你看了觉得"对，就是这个意思"，那就可以点 下一步 了。如果你看完心里还打鼓，就继续聊，别急着往下走。

聊完之后点 下一步，系统会把你这段对话自动总结成一份精简摘要（这一步在后台完成，即使总结失败也不会打断流程）。

第 2 步 · 生成 PRD/TAD

点完「下一步」，界面会转一圈，显示「AI 正在撰写 PRD 和 TAD，请稍候...」。这一步 AI 在做两件事：

为什么一定要先有这两份文档？因为它们是 AI 后面所有工作的"施工图纸"。没有图纸，AI 就凭自己的理解自由发挥，做出来的东西对不对全看运气；有了图纸，AI 是在执行一份你确认过的方案，跑偏的概率大大降低。这也正是「软件工程向导」和普通任务最根本的区别。

第 3 步 · PRD 确认

生成完成后，界面会切换到一个文档预览页。左上角显示文档名 PRD.md，右上角有一个按钮可以 编辑 / 预览 来回切换——预览是排版好的样子，编辑是纯文本，你可以直接改。

非技术背景的你，重点检查这四条：

• 目标用户对不对：文档里说的"谁会用这个功能"，跟你心里的答案一致吗
• 功能边界对不对：列出来的功能，有没有多做你不想要的，或者漏了你必须有的
• 验收口径对不对：文档里写的"什么算做完"，是不是你认可的完成标准
• "不做什么"有没有写进去：明确排除的东西，将来 AI 才不会自作主张加上

确认没问题，点 保存并下一步。你刚才在编辑框里做的任何修改，会一起保存下来。

第 4 步 · TAD 确认

接着是 TAD.md 的预览页，界面和第 3 步一样（文档名变成 TAD.md，同样有 编辑 / 预览 切换）。这一步很多人觉得"技术文档我看不懂，直接下一步算了"，其实只看几个点就够了：

同样，改完点 保存并下一步。

第 5 步 · 评审对话

这一步又是一个对话框，输入框占位提示是「输入评审意见，与 AI 多轮讨论 PRD/TAD...」。它是一个"提意见"的环节——把你在前两步没搞懂、不放心、想调整的地方，直接说出来。

聊完之后，点底部的 应用评审 按钮。这个按钮的作用是：把你这一轮对话里提的所有意见，交给 AI 去重写 PRD 和 TAD，把合理的建议吸收进去、把缺陷修正掉。所以"应用评审"不是"确认"，而是"按我说的改一遍文档"。

第 6 步 · 生成模块

点「应用评审」后进入这一步，界面显示「正在生成模块文档与开发计划...」。这里解释一个关键概念：

什么叫"模块"？就是把一个软件功能，拆成一块块相对独立的部分。比如"优惠券功能"可能被拆成：优惠券管理、券码校验、折扣计算、订单记录、后台配置页。每一块就是一个模块。

系统会从你确认过的 TAD 里提取出模块清单，然后为每个模块单独生成一份详细设计文档，最后再生成一份开发计划。这些文档会保存在项目工作区里（模块文档放在你这个软件子目录的 TAD/ 下，开发计划是 dev-plan.md）。

模块和任务是什么关系？模块是"设计层面的划分"，任务才是"执行层面的单位"。最终创建出来的任务，会带上这句指令：参考 PRD、TAD 和开发计划，按模块逐个实现、逐个测试。也就是说，模块清单就是 AI 后面排班干活的顺序表。

第 7 步 · 完成 / 创建任务

最后一步，界面顶部会出现一条绿色的成功提示：「PRD / TAD / 模块文档已生成完毕」。下面是一个只读的文本框，标题是「最终任务提示词（将用于创建任务）：」，里面就是要交给 AI 执行的完整指令（包含各文档的存放位置和"自主进行、无人值守、拆成 10~200 个小型任务串行实现"这类要求）。

走到第 7 步本身，任务还没有提交。这一步只是把"将要交给 AI 的完整提示词"预览给你看，任务仍然停在「规划中」。只有你点了 创建任务，它才真正落地。所以这一步可以安心多看几遍，不满意就点「上一步」回去改。

确认无误，点底部的 创建任务。屏幕上会提示「软件工程任务已创建」，向导关闭，任务列表刷新。

这时候发生的事情是：任务的提示词被填好了，状态从"规划中"变成待执行（pending），正式进入自动运营的排班，接下来就交给 AI 一轮一轮去做了。具体怎么排班、怎么验收，见第 09 章。

任务提交之后，这份规划就"锁"住了：在任务列表里，已提交的软件工程任务会多出一个 查看规划 按钮，点它可以只读回看生成的文档和最终提示词，不能再改、也不能重复提交。

完整时间线与心理预期

第一次走完整个向导，你心里要有个数，免得中途以为"卡死了"：

卡住怎么办：如果某一步的转圈状态超过了好几分钟还没动静，先回想一下自己点了几次按钮——重复点击可能触发多次生成。如果是生成失败，界面会显示失败态和一个「重试」按钮，点它原地重试即可；也可以点 上一步 退回去再试，或者关掉向导，在任务列表里点 继续规划 重新进入（会回到你上次的步骤）。别忘了：关掉向导不会丢掉已经生成到服务器上的文档，向导进度也会保留。

三、正道 B：修改已有软件功能（软件修改弹窗）

做好的功能要改，走的是「软件修改」。进入方式：任务管理 → 新建任务 → 任务类型选 软件修改 → 在「关联软件工程」里选好要改的那个工程 → 填好名称和描述 → 点 保存。

弹出来的对话框标题是「软件修改」。里面的元素不多，但每一个都很关键：

这个弹窗的精髓：两段式设计

它不是让你"直接填一句要求就干活"，而是把动作拆成了两段：

1. 第一段：先跟 AI 把需求聊清楚

   你在聊天区用大白话描述想怎么改。AI 会结合这个工程已有的需求文档、设计文档和代码目录结构来理解你的意思，并且可以反问你。聊的过程中，它会在草稿框里帮你把"改法"整理成一段专业、完整的任务提示词。

2. 第二段：草稿定型了，再创建任务

   你看草稿框里的提示词，觉得到位了就点 确认创建任务。如果还差点意思，可以直接在草稿框里手改，或者点 再生成一次 让 AI 重写一版。

修改需求描述模板

在聊天区里，按这个结构说，AI 一次就能抓住重点：

三个对照案例：模糊 vs 可执行

四、什么情况才该用普通「新建任务」

普通「新建任务」（任务类型保持「通用任务」）不是"低级选项"，它只是不做设计阶段的直接执行。用对地方，它又快又好。

适合用通用任务的场景：

引擎怎么选：循环执行 vs Agent 智能体

"引擎类型"决定了 AI 用哪种方式干活，界面上有两个选项：

如果你把任务类型选成了「新建软件工程」或「软件修改」，同时又选了 Agent 智能体，界面上会跳出这样一条告警（原文）：

Agent 引擎可能无法完成软件交付，仅适合简单项目，建议使用循环执行

一句话口诀：交付物是代码 / 网页 / 能运行的东西，就走软件工程或软件修改，并选循环执行；交付物是文字 / 图表 / 素材，就用普通任务，引擎按需要选。

五、软件工程与项目的其他部分怎么联动

软件工程不是一个孤立的对话框，它和项目里好几个地方是打通的。知道这些联动，你能少踩很多坑。

与任务列表：规划中的任务可以"继续"

软件工程和软件修改任务在创建时会处于规划中状态，在任务列表的"类型"列会显示 软件工程 或 软件修改 标签。处于规划中的任务，操作列会多出 继续规划（软件工程）或 继续修改（软件修改）按钮，点它就能回到向导/弹窗接着做。

与知识库：让 AI 参考你的产品资料

如果 AI 在设计或开发时能读到你项目里的产品资料、行业知识，做出来的东西会更贴近你的业务。做法是先把资料放进项目知识库（见第 07 章），AI 在开发过程中就会参考。软件修改对话框里的 AI，也会读取源工程的需求文档、设计文档和代码目录结构，这就是它"看懂现状"的方式。

与测试：软件类任务完成后有测试记录留痕

软件类任务执行时会产生测试运行记录。在自动运营的快捷入口里有一个 测试运行，打开是「测试运行记录」页面，列表里有这些列：测试 ID、任务、通过（通过 / 未通过）、引擎、改动说明、测试目标、耗时、时间、详情。点开详情能看到「输出尾部」和「错误信息」，用来判断这次改动到底测出什么问题。

与部署：改动上线要靠"自动构建部署"

代码写完要真正跑起来（部署），需要项目开启对应功能。路径是：设置 → 功能管理 → 选中项目，打开 「自动构建部署」 开关（它的内部代号是 deploy）。没开这个开关，AI 的改动可能停留在"代码写好了"但没上线。功能管理页的完整说明见第 05 章。

与验收：独立验收 Agent 会对照任务描述判定

任务做完后，会有独立的验收 Agent 去对照任务的描述判断"到底做没做对"，结论可能是通过、返工或驳回（三权分立验收，见第 09 章）。这就是为什么"怎么验证"一定要写进需求——你写清楚了验收标准，验收 Agent 才有依据；你写"你懂的"，它就只能按它自己的理解判。

与备份：改动前先确认自动备份已开

改代码有改坏的风险。项目里有一个「自动备份」页面（在运维与报告分组下），对应的功能开关是 「自动备份」（内部代号 backup）。在让 AI 大改之前，建议先确认它是开着的，这样出了问题才有东西可以回滚。

六、需求写得好，返工少一半

这一节是给非技术背景的你准备的。你不需要懂代码，但你需要会把想法"翻译"成 AI 能执行的需求。记住一个四要素模板：

五个常见坏习惯

从模糊想法到可执行需求：一个改写示范

假设你的原始想法是："我想让客户能领优惠券，这样他们就更愿意下单。" 这句话对 AI 来说太模糊了。我们一步步把它拆开：

1. 拆出"做什么"

   原始：客户能领优惠券。
   改写：做一个优惠券功能——运营可以创建优惠券并设置满减规则与有效期；买家可以在活动页领取优惠券。

2. 拆出"给谁用"

   两类人：运营同事（创建和管理券）、已注册买家（领取和使用券）。把这两类人写清楚，AI 才知道要做两个入口。

3. 拆出"什么样算做完"

   写成可检查的标准：运营能创建一张"满 100 减 20"的券；买家领取后能在"我的优惠券"里看到；下单时能选用，且订单金额确实减了 20；同一张券只能用一次。

4. 拆出"不能碰什么"

   这次不做分享转赠、不做多券叠加、不改动现有的订单结算流程。

5. 最后拼成一段可以直接用的话

   把上面四块按顺序连起来，就是一份 AI 能直接执行的需求。

七、版本迭代怎么管

软件功能很少一次做到位，都是一轮一轮改出来的。用这套引擎，迭代要注意四件事：

八、本章小结与下一步

• 想做新功能 → 任务类型选「新建软件工程」，走七步向导；改已有功能 → 选「软件修改」，先选源工程再跟 AI 聊；只要文档/分析/素材 → 用通用任务。
• 不要直接新建一个"开发某某功能"的通用任务，那等于让 AI 自由发挥，返工率高。
• 软件工程向导七步：需求对齐 → 生成 PRD/TAD → PRD 确认 → TAD 确认 → 评审对话 → 生成模块 → 完成。PRD 是"做什么"，TAD 是"怎么做"。
• 软件修改弹窗是"两段式"：先跟 AI 把改法聊清楚、生成提示词草稿，再点「确认创建任务」。草稿为空不能创建。
• 软件类工作一律选循环执行引擎；写需求记得带上"做什么 / 给谁用 / 什么样算做完 / 不能碰什么"四要素。

到这里，你已经知道"怎么把一件事交给 AI 去做"。但任务点下去之后，系统内部到底发生了什么——谁在执行、什么时候自动调用智能体、钱是怎么花的、失败了怎么办？下一章我们把这条链路完整走一遍。

附录 A · 需求对齐话术模板

下面每条都可以直接复制到「需求对齐」对话框或「软件修改」聊天区里，把方括号里的内容换成你自己的。它们的共同点是：说清了范围、给了可验证的标准、划了边界。

附录 B · 软件工程向导七步检查清单

每一步都给你"完成标志 / 你要检查什么 / 常见坑"，可以逐条勾选。

附录 C · 任务类型与引擎选择决策表

一张表把"我想做 X"该选什么全部给全。时间片权重和优先级是建议值，可按实际情况调整。

附录 D · 一个完整案例的文档样例结构

以"给跨境电商独立站加一个优惠券功能"为例，让你知道 AI 产出的 PRD 和 TAD 大概长什么样、你该看哪里。

PRD.md 该包含哪些小节

TAD.md 该包含哪些小节

看到这里，你已经掌握了"把软件功能交给 AI"的两条正道。接下来第 11 章会带你走一遍任务执行的全过程，看看这个任务从创建到跑完，中间到底发生了什么。

附录 E · 软件功能开发常见问题速查